Home
Upgrading and migrating
Learn how to upgrade HCL Launch elements, including the server, agents, and how to migrate data.

Upgrading and migrating
Learn how to upgrade HCL Launch elements, including the server, agents, and how to migrate data.
- Testing an upgrade
  Before you upgrade your production HCL Launch server, for best results, perform a test upgrade, verify the challenges you are facing, and resolve them before performing an actual upgrade.
- Upgrading the server
  You can upgrade the HCL Launch server to incorporate to a later version. Always upgrade agents, agent relays in addition to upgrading the server. Upgrading the server, agents, agent relays are each completed independently. Unless specified, upgrade the server before you upgrade the agents.
- Upgrading high-availability installations
  All servers that are configured for the HA feature must be on the same version. Thus, all servers must be upgraded at the same time.
- Upgrading agents
  In most cases, you upgrade agents from the server interface, but you can also upgrade the agents from the command line. Always upgrade agents and agent relays in addition to upgrading the server.
- Upgrading agent relays
  In most cases, you upgrade agents relays from the command line, but starting from 7.0.4.2 version, you can upgrade the server from the interface. Always upgrade agents and agent relays in addition to upgrading the server.
- Upgrading encryption key strength
  When you upgrade the server from version 6.0.1.1 or earlier to a version later than version 6.0.1.1, you can upgrade the SSL encryption.
- Migrating the server database
  The server installation files include a script that migrates the server database from Derby to another database system. You can not migrate from any database other than Derby.
- Migrating Codestation from filesystem repositories to S3 repositories
  You can migrate your Codestation artifacts from filesystem to S3 using the S3 migrator tool.
- Migrating the server to Kubernetes/Openshift
  You can migrate your HCL Launch server from an on-premises production installation to a containerized instance that runs in a Kubernetes or Openshift cluster.
- Migrating an existing IBM® installation to HCL Launch

Upgrading and migrating

Learn how to upgrade HCL Launch elements, including the server, agents, and how to migrate data.

Best practices for upgrade

Follow these best practices for a smooth upgrade process:

Open a support case to discuss your upgrade plan.
Clean up your data to make your backups easier and minimize the upgrade time.
Create a backup of all of your data and learn how to restore it.
Read the release notes to know about the features introduced, defects fixed, and any deprecations starting from your current version to the version your want to upgrade.
Review the upgrade notes that lists each build-specific considerations that are important before you upgrade.
Clone your production server and test upgrade to fix issues that you may encounter during real-time upgrade.